home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / utils / basecalc.lzx / basecalc.txt < prev    next >
Text File  |  1994-04-01  |  8KB  |  237 lines
  1.  
  2.  
  3.                                   Install
  4.  
  5.  Copy BaseCalc.opa to the APP directory on any drive and install with
  6. <Psion>I.
  7.  
  8.  Note: Use the outline feature in Word for table of contents.
  9.  
  10.  
  11.                              General Overview
  12.  
  13.  BaseCalc displays a 32 bit number in 4 "bases" across the screen. The
  14. "bases" are ASCII, binary, decimal and hexadecimal.  The display is set up
  15. as a "scrolling tape" so results from previous calculations show. Grey grid
  16. lines are used to section large numbers and to mark the result of a
  17. calculation. The operator is shown in the last column
  18.  
  19.  There is one input window that can be moved to any of the four columns by
  20. using the  left or right arrow keys. This location determines the base in
  21. which you input your numbers.
  22.  
  23.  The processing of numbers and operators are Reverse Polish Notation (RPN
  24. or postfix notation) and is modeled after Hewlett Packard (HP) calculators.
  25. To add two numbers input the first number and press <Enter> (set the
  26. accumulator) input the second number and press <+> the accumulator (first
  27. number) and the second number are then added together and the result is
  28. shown (which is now in the accumulator.) A more detailed explanation of
  29. this and other internal registers are in a latter section.
  30.  
  31.  A brief description of keys and functions are available in the program
  32. when you press <Help>. I would advise to read the ASCII section before
  33. seriously diving into the program since its use and behavior is not
  34. immediately obvious.
  35.  
  36.  Note: BaseCalc uses no files (just like Calc.)
  37.  
  38.  
  39.                                    About
  40.  
  41.  Pressing <Psion>A display the BaseCalc version number, copyright notice
  42. and a plea to register the software. I have a family of four loving kids
  43. and wife. They all depend on me for financial support. I can really use the
  44. money, or a decent job offer.
  45.  
  46.  Registration will get you a version of the program without the nag screen.
  47.  
  48.  After years of putting up with other peoples programmers calculators and
  49. wishing they would do more. I finally put together my own. I hope you enjoy
  50. the ideas and functionality I tried to put into this package. If you have
  51. any complaints or suggestions feel free to write or call.
  52.  
  53.                               Barry Childress
  54.                          3415 North Second Street
  55.                             Harrisburg PA 17110
  56.                                      
  57.                 Phone (717)234-0750  Compuserve 73510,1420
  58.                                      
  59.  
  60.  In case you were wondering the program's icon is a truth table for And (&)
  61. Xor (^) and Or (|).
  62.  
  63.  I would like to thank Cade Roux for his ideas on the ASCII input.
  64.  
  65.  
  66.                                  Features
  67.  
  68.  Most features are accessible through the <Menu> key or with the Psion
  69. short cut key. A brief help screen is also provided.
  70.  
  71.  * The amount entered is defined as a number in the input window before an
  72. operation is selected.
  73.  
  74. General Keys
  75.  
  76.  The left and right arrow keys select which base that you want to enter
  77. your numbers in. Note: it is possible to overflow the 32 bit register with
  78. a decimal number.
  79.  
  80.   <Esc> Clears the accumulator. See <Psion>-C to clear all registers.
  81.  
  82.  <Psion>L Sets the accumulator to the result before the last operation.
  83. This works like a single level undo.
  84.  
  85.  <Psion>X Exit BaseCalc.
  86.  
  87. Math operators
  88.  
  89.  Note: If no number is entered the stack is popped and the 2nd accumulator
  90. on the stack becomes the amount entered (The accumulator remains the same
  91. before the operation.)
  92.  
  93.  + Adds the amount entered to the accumulator.
  94.  - Subtracts the amount entered from the accumulator.
  95.  * Multiplies the amount entered by the accumulator.
  96.  / Divides the accumulator by the amount entered.
  97.  # Sets the accumulator to the amount entered power.
  98.  
  99.  Note: If a number does overflow the accumulator is cleared and an E is
  100. displayed in the right operator column
  101.  
  102. Binary operators
  103.  
  104.  These operators work the same way the math operators work on the
  105. registers. Except for ~ (not) which is a urinary operator and its operation
  106. is explained below.
  107.  
  108.  Note: The icon for BaseCalc is the truth table for the first three
  109. operations.
  110.  
  111.  & And the accumulator.
  112.  \  Or the accumulator (the | symbol is used in the right column .)
  113.  ^  Exclusive or (xor) the accumulator.
  114.  ~ Not the amount entered and push it on the stack or if there is no amount
  115. entered ~ is performed on the accumulator.
  116.  
  117. Shift bits
  118.  
  119.  < (or ,) Shift the accumulator left by the amount entered or by the amount
  120. on the stack.
  121.  > (or .) Shift the accumulator right by the amount entered or by the
  122. amount on the stack.
  123.  
  124.  Note: Bits shifted left beyond 32 bits can result in an overflow error.
  125.  
  126. Stack operations
  127.  
  128.  Show <Psion>S
  129.  Displays the stack and Last register. The lines are noted with the
  130. following symbols in the operator column:
  131.      L    Last
  132.      ...  Bottom of stack (auto repeats)
  133.      3    Third item on stack
  134.      2    Second item on stack
  135.      Ï    The accumulator
  136.  
  137.  Last <Psion>L
  138.  The sets the accumulator to the last result that was in the accumulator
  139. (undo.)
  140.  
  141.  Exchange <Psion>E
  142.  Exchanges the accumulator with the second item on the stack. Or if there
  143. is an amount entered it gets pushed on the stack underneath the accumulator
  144. (the amount entered becomes the second item on the stack.)
  145.  This helps correct the order of items before an operation such as divide
  146. or power.
  147.  The operator symbol is X.
  148.  
  149.  Pop <Psion>P
  150.  Pops a register off the stack (discards the current accumulator.)
  151.  
  152.  Clear All <Psion>C
  153.  Clears all registers.
  154.  The operator symbol is A
  155.  
  156.  
  157.                                  Examples:
  158.  
  159.  In going through a VGA programming example book I ran across this example
  160. of a bit pattern for a striped rainbow effect that had me a bit puzzled
  161. till I entered the numbers in BaseCalc and looked at the "sideways" in the
  162. binary column. Try entering the following numbers in Hex and see if you can
  163. see the bit pattern.
  164.      CCCC CCCC
  165.      F0F0 F0F0
  166.      FF00 FF00
  167.      FFFF 0000
  168.  
  169. RPN
  170.  
  171.  To add 1+1
  172.      1<Enter>
  173.      1+
  174.  
  175. Constant numbers
  176.  
  177.  To use a number as a constant, push it on the stack four times so as it is
  178. popped off it repeats in the forth stack register.
  179.  
  180.      1<Enter><Enter><Enter><Enter>
  181.      <    (Shift right by 1)
  182.      <    (...)
  183.           (Shows the powers of 2)
  184.  
  185. ASCII
  186.  
  187.  One use for the ASCII column is to find the ASCII value for a key. With
  188. the input window in the ASCII column (small window on the left) press the
  189. key you want to find the value of and then press <Enter>.
  190.  
  191.  You also can use ASCII values in operations. To find the difference
  192. between upper and lower case letters:
  193.      a <Enter>
  194.      <Shift>A -
  195.  
  196.  Converting a Hex string to its value is generally a two step process where
  197. you first subtract the value of ASCII "0" and if the result is larger then
  198. nine then it is a A-F digit. The calculations would go like this:
  199.      <Shift>A <Enter>
  200.      0 -
  201.  (move to Dec column and subtract what the value should be.)
  202.      10 -
  203.  
  204.  Or the same thing without moving  the input window.
  205.      <Shift>A <Enter>
  206.      0 -
  207.      <Control>010 -
  208.  
  209.  <Control> xxx inputs the ASCII character with the decimal value xxx.
  210.  
  211.  Now lets double check against the Hex digit F.
  212.  (move back to the ASCII column.)
  213.      <Shift>F
  214.      0 -
  215.        -  (This subtracts the 7 from our last calculation.)
  216.  
  217.  And we get F in the Hex column.
  218.  
  219.  You can also use the ASCII column to get the codes for any key on the
  220. Psion by first pressing <Tab> then the key you want the code for and
  221. finally <Enter> or any other operation key.
  222.  
  223.  Notes: 
  224.  You will also need to press <Tab> first if you want to enter one of the
  225. operators (+-*/\~^&<>,.). 
  226.  You can use <Control>A as a quick way to enter 1. <Control>A through
  227. <Control>Z are ASCII codes  1-26 but some codes are taken as regular key
  228. presses (8-Delete, 9-Tab, 13-Enter and the system swallows ^S and the next
  229. key.)
  230.  
  231.  
  232.                                  Copyright
  233.  
  234.  BaseCalc is Copyrighted 1994 by Barry Childress  All rights reserved. The
  235. program may be distributed provided all documentation remains intact and
  236. fees for distribution do not exceed $7.
  237.